home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games Extra 1996 June / Amiga Games Extra 1996 #6.iso / spiele / publicdomain / landmine / landmine.doc < prev    next >
Text File  |  1996-04-04  |  17KB  |  439 lines
  1.  
  2.  
  3.                          Landmine Version 2.00
  4.                  Copyright © 1990 - 1993 , Perry Rosenboom
  5.                      Documentation Version - June 1993
  6.  
  7.                              Perry Rosenboom
  8.                                 Box 333,
  9.                              Wantirna South,
  10.                              Victoria, 3152
  11.                                Australia
  12.  
  13.  
  14.                              Introduction
  15.  
  16. Landmine is based on a game which has been floating around the place
  17. for a while.  A few years ago I looked around for something on the Amiga, 
  18. couldn't find it, and wrote my own.  Of course, since I wrote my original
  19. version of Landmine (in 1990), many other similar games have been released.
  20. Nevertheless, I decided to produce this second version of the original game
  21. for the people who registered for version 1.  The bug fixes (there are a 
  22. couple) and changes (there are heaps) are listed below.  I hope you like
  23. Landmine Version 2!.
  24.  
  25.  
  26.                     A Note about this documentation
  27.  
  28. This file accompanies both the Shareware version and Registered version of 
  29. Landmine 2.00.  Differences between the two versions will be specified 
  30. wherever appropriate.  This means that I only need to maintain one version 
  31. of the documentation (mainly because I hate writing documentation).  
  32. Having only one version of the documentation will also show Shareware 
  33. Users what you are missing by not registering!!!!
  34.  
  35.  
  36.                            Version History
  37.  
  38. Version 1.00: Shareware version, released late 1990 via Fred Fish.
  39. Version 1.01: Registered version, released during 1991 and 1992 to registered
  40.               users only.
  41. Version 2.00: Available in Shareware and Registered versions, released June
  42.               1993.
  43.  
  44.  
  45.                   Bug fixes from Version 1.00 and 1.01
  46.  
  47. Loading and Saving
  48.  
  49. Various people iinformed me that sometimes when games were saved, they would
  50. not load correctly.  As a result, I rewrote the loading and saving routines, 
  51. and (hopefully!) fixed the bugs.  The down side of this is that Landmine 2
  52. will not read in saved games from Landmine Version 1.
  53.  
  54. Previously, after you loaded an old game, it did not start immediately.  That
  55. problem has now been fixed in this version.
  56.  
  57.  
  58.                    Changes from Version 1.00 and 1.01
  59.  
  60. There are many new things in Version 2 of Landmine.  They include:
  61.  
  62. Title screen:  The title screen has been completely redone so that it uses
  63. less memory, and so that it doesn't take as long to run through.  Registered
  64. users also have the option to skip the title screen (see Menu Settings).  I'm
  65. going to make you sit through the title screen each time if you have the
  66. shareware version!
  67.  
  68. Menus: The menus have been redone so that they look different, and are a
  69. little more interesting to use.  There are also a few extra options in the
  70. menus which are detailed in the "Menu" section below.
  71.  
  72. Playing Screen: The playing screen is now a little more elaborate.  There
  73. are a number of setting which can be controlled through the menus, and the
  74. status of these setting is displayed on the playing screen.
  75.  
  76. The board: The board now looks more interesting whenever you clear new
  77. squares.  I'll let you take a look for yourself!
  78.  
  79. Game play: You now have the option of having Lanmine 2 automatically clear
  80. the 'zero' squares (registered version only).  This makes the game a little
  81. easier to play, and also a little quicker to finish each level.  Also, you
  82. can select whether to display the positions of ALL of the mines, if you get
  83. blown up.  This option was included to allow you to have another go at a
  84. saved game, without knowing where all the mines are.  Thanks to John Ray for
  85. the suggestion!
  86.  
  87.                           Systems Supported
  88.  
  89. This game was developed and compiled using AMOS and AMOS Compiler (Copyright
  90. Euorpress) version 1.35, which supports Workbench 1.3, 2, and 3.  This means
  91. that this game should work on A500, A600, A1200, A2000, A3000 and A4000 
  92. machines.  I do my best to support machines available at the time of
  93. writing the game, however I obviously cannot test every aspect of the game on
  94. every machine.  If for some reason the game doesn't work, check the 'Troubles?'
  95. section below, and send me a polite letter, and I'll see if I can help.
  96. Obviously, registered users get priority.  Abusive letters (such as one I
  97. received from England) will get no response.
  98.  
  99. People who write shareware and public domain software do so because they enjoy
  100. it - abuse will only result in LESS software being developed for public release.
  101. We can't hope to make our shareware profitable, but we do hope that we are
  102. respected for our efforts.  End of sermon.
  103.  
  104.  
  105.                          Object of the game
  106.  
  107. The object of Landmine is simple.  You are presented with a grid which
  108. measures 15 squares by 10.  At level 1, there are 20 mines buried somewhere
  109. within the grid.  To complete the level, you need to reach the bottom right
  110. corner of the grid.  If you do so without stepping on a mine, you go to the
  111. next level and the number of mines increases.  You score one point for each
  112. square which is cleared, and you get bonus points at the end of each level
  113. (maximum bonus points are awarded for clearing every non-mined square).
  114. To help you reach your objective, the number of mines adjacent to your current
  115. location is displayed.  With some thought, you can usually work out where the
  116. mines are buried.  All movement is carried out using the mouse.
  117.  
  118. Oh yeah - if you step on a mine, you're dead!
  119.  
  120. There are much more comprehensive instructions built into the game - when you
  121. fire it up, take a look at the menus.
  122.  
  123.  
  124.                                 Rules
  125.  
  126. 1. You may only move to a square adjacent to the square you are currently in.
  127. 2. The only way to move to the next level is to move to the bottom right
  128.     corner of the board.
  129. 3. There is no rule 3.
  130.  
  131.                               How to Play
  132.  
  133. Only mouse clicks are required to play Landmine.
  134.  
  135. To move from one square to another, click on the square you wish to move to
  136. using the left mouse button.  Remember that you can only move to an adjacent
  137. square.  The current settings are displayed on the right hand side of the
  138. screen.  To change the settings, use the appropriate items from the menu.
  139. Some items are disabled in the Shareware version of Landmine - these are
  140. described in detail below.
  141.  
  142.  
  143.                                  Menus
  144.  
  145. A number of menu items are available with Classic Solitaire.  Clicking on
  146. the right mouse button will make the menus appear.
  147.  
  148. Available menu items are coloured dark green and will change colour to 
  149. yellow when they are selected.
  150.  
  151. A grey menu item means that the item is not available
  152.  
  153. Menu Items available are:
  154.  
  155.   -----------------------------------------------------
  156.   |  Landmine  |  Settings  |  High Scores  |  Help!  |
  157.   -----------------------------------------------------
  158.  
  159. Under the "Landmine" option, you are presented with the following submenu:
  160.  
  161.  --------------
  162.  |  Landmine  |
  163.  --------------
  164.   | Start Game |
  165.   | Load Game  |
  166.   | Save Game  |
  167.   | About..    |
  168.   | Credits    |
  169.   | Quit       |
  170.   --------------
  171.  
  172. Start Game:
  173.  Selecting this options allows you to start a new game if you happen to step
  174.  on a mine.  This option is not available while you are playing an existing
  175.  game.
  176.  
  177. Load Game:
  178.  Allows you to load a previously saved game.  Choosing this option will present
  179.  you with the AMOS file requester.  You can use this to locate your saved game.
  180.  After the game is loaded, the game is ready to be played.
  181.  
  182. Save Game:
  183.  Allows you to save a current game.  Choosing this option will present you with
  184.  the AMOS file requester.  You can use this to locate the directory (drawer) 
  185.  that you wish to save your game in.  The default directory is the directory
  186.  in which Landmine is stored.  Saved Landmine games automatically have an
  187.  extension of '.LMSAVE' appended to the filename.
  188.  
  189. About..
  190.  Provides some information about this version of Landmine.  This screen will
  191.  also contain the name of the registered user, if you are running a registered
  192.  version.
  193.  
  194. Credits
  195.  Some people I need to thank.  Unfortunately, I couldn't fit everyone's name on
  196.  this screen - sorry!
  197.  
  198. Quit
  199.  Quit, Exit, Scram, Vamoose, Leave, Abort, Getoutahere......
  200.  
  201.  
  202. Under the "Settings" option you are presented the the following submenu:
  203.  
  204.  -----------------
  205.   |  Settings  | 
  206.  -----------------
  207.    | Sound    |
  208.    | Settings |
  209.    ------------
  210.  
  211. Sound:
  212.  Allows you to turn the sound  on or off.  Notes that this setting has no
  213.  effect on the title screen.
  214.  
  215. Settings:
  216.  This menu item presents a screen with many options on it.  The options are:
  217.  
  218.  Sound
  219.   Bell On / Bell Off
  220.     This performs the same task as selecting the "Sound" submenu item directly
  221.     from the menu.
  222.  
  223.  Menu
  224.   Floating / Fixed
  225.     Allow you to choose whether you want the menu to be displayed at the
  226.     current mouse pointer position, or at the more traditional top left
  227.     corner. Set to 'Floating' in Shareware version.
  228.  
  229.  Title
  230.   Show / Skip
  231.     Allows you to either skip or show the title screen the next time that
  232.     Landmine is started.  Set to 'Show' in Shareware version.
  233.  
  234.  Flash
  235.   On / Off
  236.     Set the flashing on the playing screen to either on or off.  Set to 'On'
  237.     in the Shareware version.
  238.  
  239.  Clear
  240.   On / Off
  241.     When this option is set to 'On' Landmine will automatically clear all
  242.     squares which have a value of zero, and give the appropriate number of
  243.     points.  This option is set to 'Off' in the Shareware version.
  244.  
  245.  Display
  246.   On / Off
  247.     When set to 'Off' this option will display the position of all mines when
  248.     you get blown up.  Setting this to 'On' will only display the current
  249.     mine.  This allows you to load a saved game and give it another go! This
  250.     option is set to 'On' in the shareware version.
  251.  
  252.  Use, Save and Cancel Buttons
  253.   These buttons allow you to use the settiings for the remainder of the current
  254.   session, save the setting to a file for use in future sessions, or forget
  255.   about the changes you have just entered.
  256.  
  257.  
  258. Under the "High Scores" menu item you are not presented with a submenu.
  259. This menu item will display the list of high scores.
  260.  
  261.  
  262. Under the "Help!" option you are presented the following submenu:
  263.  
  264.  ------------
  265.   |  Help!  | 
  266.  -----------------
  267.    | Object      |
  268.    | Moving      |
  269.    | Scoring     |
  270.    | Load/Save   |
  271.    | High Scores |
  272.    ---------------
  273.  
  274. This menu and submenu provides some on-line help regarding the playing of
  275. Landmine Version 2.00.
  276.  
  277.  
  278.                          The Shareware version
  279.  
  280. If you have already registered, then ignore this section.  
  281.  
  282. The shareware version of Landmine differs from the Registered Version in a
  283. number of ways:
  284.  
  285. 1.    Some features have been disabled in the shareware version.  
  286.     Registered users have:
  287.  
  288.    -    the ability to fix of float the menu (the shareware version is set to
  289.         'Floating');
  290.    -    the option to turn flashing on or off (set to 'On' in the Shareware
  291.         version;
  292.    -    the ability to skip the title screen (although it's such a good 
  293.     title screen, I don't know why anyone would want to skip over it...);
  294.    -    the option to clear the board of all 'zero' squares at the start of a
  295.         game; and
  296.    -    the option to turn the display of mines off when you get blown up.
  297.  
  298. 2.    The shareware version has a message which flashes up at random
  299.     while playing the game, to remind you (just in case you need reminding) 
  300.     that the version of the game you are playing is Shareware.  This does
  301.     not come up on the registered version.
  302.  
  303. 3.    Registered versions of Landmine contain the name of the person who
  304.     registers in the title screen, and the "About" screen (so everyone who
  305.     registers has their own personal copy of the game).
  306.  
  307. 4.    The Shareware version of Landmine is not supported.  In other words, if
  308.     there is a problem, I'll attempt to fix it in the Registered version, and
  309.     registered users will receive the fix.
  310.  
  311. 5.    The Shareware version of Landmine is 'crunched' on the disk, to reduce
  312.     the amount of space required for coverdisks, PD libraries, Bulletin
  313.     Boards and so on.  The process of uncrunching causes the coloured
  314.     lines on the screen when you start the game.  Registered users will
  315.     receive an 'uncrunched' version of the game.
  316.  
  317.  
  318.                                   Troubles?
  319.  
  320. Most problems seem to be caused by low memory.  If you notice that the screen
  321. is not refreshing correctly, or that the menu bar doesn't disappear, you've
  322. got memory problems.  Most games these days are designed to work in 1Mb
  323. minimum, and this game is no different.  If you have 1Mb or more and the game 
  324. is still presenting problems (especially after you have been playing the same
  325. game for some time), then the memory may be fragmented.  Try closing down some
  326. other programs, or closing down the game and restarting it.
  327.  
  328. The other problem which I have heard of can occur on Workbench 2 and Workbench
  329. 3 systems.  On these systems, it is possble to change the default font to
  330. something other than 'Topaz 8'.  This game was written using the default Topaz
  331. 8 font, so if you notice that text does not fit properly in boxes or on the
  332. screen, you may need to alter your Workbench setting and restore 'Topaz 8' as
  333. the default font.
  334.  
  335.  
  336.                               Registration Details
  337.  
  338. If you have already registered, then ignore this section.  
  339.  
  340. Registering for Landmine V2.00 will provide you with the Registered version of
  341. the game, any changes or bug fixes, and the next major upgrade.  This means 
  342. you will receive all versions 2.xx and version 3.00, if I write it.  I'm hoping
  343. that the game is so good that there will never be a need for version 3......
  344.  
  345. The price....
  346.  
  347. To register for Landmine V2.00, send the appropriate amount to:
  348.  
  349.             Perry Rosenboom
  350.             Box 333
  351.             Wantirna South
  352.             Victoria, 3152
  353.             AUSTRALIA
  354.  
  355. To make registration easier, you can send local currency (cash please) in 
  356. the following amounts:
  357.  
  358.         
  359.     Australia        $10.00
  360.     New Zealand        $15.00
  361.     England            £5.00
  362.     United States        $10.00
  363.     Germany            Dm 10,00
  364.     Canada            $10.00
  365.  
  366. Please send cash only, as our banks act like robbers and can charge us 
  367. $6.00 to change a cheque!  Cheques in Aus$ drawn on an Australian Bank are
  368. also acceptable.  Prices for each individual country are based mainly on
  369. the current exhange rate that the country has with Australia.
  370.  
  371. Why so inexpensive for an Amiga game?  Because the high price of quality 
  372. Amiga games prevents many Amiga owners from buying games.  I plan to make my
  373. millions by asking for a fair registration fee from fellow Amiga Users, and
  374. registering thousands of users, instead of ripping off a few people.  Also, 
  375. I've tried to make the whole process as painless as possible by putting in 
  376. local currency values for countries where I know some of my previous games 
  377. have been.  I understand that not everyone happens to have a few Australian
  378. dollars sitting in their cookie jar!
  379.  
  380. Well, that's the plan, and those are the reasons - The rest is up to you!
  381.  
  382.  
  383.                      Distribution of Landmine and
  384.                     other boring terms and conditions
  385.  
  386. The SHAREWARE Version of Landmine Version 2.00 may be freely distributed, 
  387. providing this documentation file accompanies the game.  Neither the Game 
  388. or this documentation may be altered in any way without the Author's 
  389. written permission.  No more than a reasonable fee for copying and 
  390. distribution should be charged for the Shareware Version of Landmine Version
  391. 2.00.
  392.  
  393. Registered Versions of Landmine are provided only to the registered user and
  394. are not to be copied or distributed under any circumstances, unless prior
  395. permission has been provided in writing by the Author (after all, a great deal
  396. of time has gone into writing this game).
  397.  
  398. The title screen and the "About" screen clearly states whether the game you
  399. are playing is the shareware version or registered version.
  400.  
  401.  
  402.                               Thanks and Credits
  403.  
  404. My sincere thanks go to the following people:
  405.  
  406. Therese and James (my wife and son) for putting up with the amount of time 
  407. I spend writing Amiga software.  A three year old bashing the keyboard makes
  408. looking for bugs in a game an interesting exercise!  I have a feeling that
  409. he will be writing better software than his dad soon....
  410.  
  411. Andrew Kreibich for finding bugs (not that I really want to thank people 
  412. for finding bugs), and for his ideas and some of the code (such as the 
  413. button routine).
  414.  
  415. The music track used in the title screen were provided with early versions of
  416. AMOS, with a game called AMOSTEROIDS.  Thanks Europress!
  417.  
  418. Landmine 2.00 was written using AMOS 1.35 and compiled with the AMOS Compiler,
  419. version 1.35, both of which are Copyright © Europress.
  420.  
  421. Thank you to all who register.  As with my other games, I'll name you all 
  422. in the next release of the game.
  423.  
  424.  
  425.                        Hello to the following people
  426.                          (in no particular order)
  427.  
  428. Rene Ulla Katoll (Germany), Phillip Bonner (South Australia), Stanley Kendall
  429. (Barrington, IL), John Ray (Queensland), Peter Smith (Germany), The Humphries
  430. Family (Grand Rapid, MI), Jurgen Brenken (Germany). 
  431.  
  432.  
  433.                                  Copyright
  434.  
  435. Landmine is Copyright © 1993 by Perry Rosenboom.  If you would like a special
  436. version for a magazine coverdisk, please write to me.
  437.  
  438.                                -------------
  439.